/*
 *
 *      Copyright (c) 2018-2025, lengleng All rights reserved.
 *
 *  Redistribution and use in source and binary forms, with or without
 *  modification, are permitted provided that the following conditions are met:
 *
 * Redistributions of source code must retain the above copyright notice,
 *  this list of conditions and the following disclaimer.
 *  Redistributions in binary form must reproduce the above copyright
 *  notice, this list of conditions and the following disclaimer in the
 *  documentation and/or other materials provided with the distribution.
 *  Neither the name of the pig4cloud.com developer nor the names of its
 *  contributors may be used to endorse or promote products derived from
 *  this software without specific prior written permission.
 *  Author: lengleng (wangiegie@gmail.com)
 *
 */

package com.pig4cloud.pig.admin.api.feign;

import com.pig4cloud.pig.admin.api.entity.SysOauthClientDetails;
import com.pig4cloud.pig.common.core.constant.ServiceNameConstants;
import com.pig4cloud.pig.common.core.util.R;
import com.pig4cloud.pig.common.feign.annotation.NoToken;
import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;

/**
 * 远程客户端详情服务接口
 * <p>
 * 通过Feign客户端调用UPMS服务的OAuth2客户端管理功能，提供客户端信息的远程查询服务。
 * 主要用于认证服务验证客户端凭证，实现OAuth2的客户端认证流程
 * </p>
 *
 * @author lengleng
 * @date 2025/05/30
 */
@FeignClient(contextId = "remoteClientDetailsService", value = ServiceNameConstants.UPMS_SERVICE)
public interface RemoteClientDetailsService {

	/**
	 * 根据客户端ID查询客户端详情
	 * <p>
	 * 通过客户端ID获取OAuth2客户端的详细配置信息，包括客户端密钥、授权模式、作用域等。
	 * 使用@NoToken注解表示该接口为内部服务调用，主要用于认证服务验证客户端
	 * </p>
	 * 
	 * @param clientId 客户端ID，如app、web、admin等
	 * @return 包含客户端详细信息的响应结果
	 */
	@NoToken
	@GetMapping("/client/getClientDetailsById/{clientId}")
	R<SysOauthClientDetails> getClientDetailsById(@PathVariable("clientId") String clientId);

}
